Draw Region Location and Dimensions11

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next

Draw Region Location and Dimensions

QuickDraw 3D provides several routines to support renderers that are handling much of the draw region work themselves. They return the X-axis and Y-axis values of various sizes and offsets of the raster.

Putting functionality at this level of detail in a renderer is strongly discouraged.

Q3XDrawRegion_GetDeviceScaleX

For a draw region, the Q3XDrawRegion_GetDeviceScaleX function lets you get the X-dimension size of the visible (onscreen) portion of the unclipped window.



 
TQ3Status Q3XDrawRegion_GetDeviceScaleX(

                     TQ3XDrawRegion    drawRegion,

                     float             *deviceScaleX);

drawRegion: A draw region.
deviceScaleX: The X-axis window size for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetDeviceScaleX function returns, in the deviceScaleX parameter, the X-axis onscreen window dimension, ignoring clipping and occlusion, for the draw region designated by drawRegion.

Q3XDrawRegion_GetDeviceScaleY

For a draw region, the Q3XDrawRegion_GetDeviceScaleY function lets you get the Y-dimension size of the visible (onscreen) portion of the unclipped window.



 
TQ3Status Q3XDrawRegion_GetDeviceScaleY(

                     TQ3XDrawRegion    drawRegion,

                     float             *deviceScaleY);

drawRegion: A draw region.
deviceScaleY: The Y-axis window size for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetDeviceScaleY function returns, in the deviceScaleY parameter, the Y-axis onscreen window dimension, ignoring clipping and occlusion, for the draw region designated by drawRegion.

Q3XDrawRegion_GetDeviceOffsetX

The Q3XDrawRegion_GetDeviceOffsetX function lets you get the X-axis window offset, relative to the monitor, for a draw region.



 
TQ3Status Q3XDrawRegion_GetDeviceOffsetX(

                     TQ3XDrawRegion    drawRegion,

                     float             *deviceOffsetX);

drawRegion: A draw region.
deviceOffsetX: The X-axis window offset for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetDeviceOffsetX function returns, in the deviceOffsetX parameter, the X-axis offset between the window and the monitor origin (upper left corner) for the draw region designated by drawRegion. With single buffering this value is the actual offset; with double buffering it is always 0.

Q3XDrawRegion_GetDeviceOffsetY

The Q3XDrawRegion_GetDeviceOffsetY function lets you get the Y-axis window offset, relative to the monitor, for a draw region.



 
TQ3Status Q3XDrawRegion_GetDeviceOffsetY(

                     TQ3XDrawRegion    drawRegion,

                     float             *deviceOffsetY);

drawRegion: A draw region.
deviceOffsetY: The Y-axis window offset for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetDeviceOffsetY function returns, in the deviceOffsetY parameter, the Y-axis offset between the window and the monitor origin (upper left corner) for the draw region designated by drawRegion. With single buffering this value is the actual offset; with double buffering it is always 0.

Q3XDrawRegion_GetWindowScaleX

The Q3XDrawRegion_GetWindowScaleX function lets you get the X-axis window dimension for a draw region.



 
TQ3Status Q3XDrawRegion_GetWindowScaleX(

                     TQ3XDrawRegion    drawRegion,

                     float             *windowScaleX);

drawRegion: A draw region.
windowScaleX: The X-axis window dimension for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetWindowScaleX function returns, in the windowScaleX parameter, the X-axis window dimension for the draw region designated by drawRegion. This dimension is the same with both single and double buffering.

Q3XDrawRegion_GetWindowScaleY

The Q3XDrawRegion_GetWindowScaleY function lets you get the Y-axis window dimension for a draw region.



 
TQ3Status Q3XDrawRegion_GetWindowScaleY(

                     TQ3XDrawRegion    drawRegion,

                     float             *windowScaleY);

drawRegion: A draw region.
windowScaleY: The Y-axis window dimension for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetWindowScaleY function returns, in the windowScaleY parameter, the Y-axis window dimension for the draw region designated by drawRegion. This dimension is the same with both single and double buffering.

Q3XDrawRegion_GetWindowOffsetX

The Q3XDrawRegion_GetWindowOffsetX function lets you get the absolute X-axis window offset for a draw region.



 
TQ3Status Q3XDrawRegion_GetWindowOffsetX(

                     TQ3XDrawRegion    drawRegion,

                     float             *windowOffsetX);

drawRegion: A draw region.
windowOffsetX: The X-axis window offset for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetWindowOffsetX function returns, in the windowOffsetX parameter, the X-axis absolute offset of the window for the draw region designated by drawRegion. This value is the same with single and double buffering.

Q3XDrawRegion_GetWindowOffsetY

The Q3XDrawRegion_GetWindowOffsetY function lets you get the absolute Y-axis window offset for a draw region.



 
TQ3Status Q3XDrawRegion_GetWindowOffsetY(

                     TQ3XDrawRegion    drawRegion,

                     float             *windowOffsetY);

drawRegion: A draw region.
windowOffsetY: The Y-axis window offset for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetWindowOffsetY function returns, in the windowOffsetY parameter, the Y-axis absolute offset of the window for the draw region designated by drawRegion. This value is the same with single and double buffering.

Q3XDrawRegion_GetDeviceTransform

The Q3XDrawRegion_GetDeviceTransform function lets you get the device transform for a draw region.



 
TQ3Status Q3XDrawRegion_GetDeviceTransform(

                     TQ3XDrawRegion    drawRegion,

                     TQ3Matrix4x4      **deviceTransform);

drawRegion: A draw region.
deviceTransform: The device transform for the draw region.

DESCRIPTION

The Q3XDrawRegion_GetDeviceTransform function returns, in the deviceTransform parameter, the device transform for the draw region designated by drawRegion.